Skip to content

SDK reference polish#6741

Merged
ethanpalm merged 2 commits into
mainfrom
codex/sdk-reference-docs-follow-up
Jul 24, 2026
Merged

SDK reference polish#6741
ethanpalm merged 2 commits into
mainfrom
codex/sdk-reference-docs-follow-up

Conversation

@ethanpalm

@ethanpalm ethanpalm commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Documentation changes

Copy edits to the SDK reference setup guide


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Low Risk
Documentation-only copy and component changes with no runtime or configuration behavior changes.

Overview
Polishes the SDK reference setup guide in sdk-reference-setup.mdx so it matches patterns used in sibling API playground docs (e.g. GraphQL setup).

Adds a <Note> on tab-only sdk usage: allowed groups, forbidden nav structures (pages, versions, languages), and incompatibility with openapi, asyncapi, and graphql.

Replaces ResponseField with ParamField for format, source, and directory. source now explicitly states HTTPS only (no HTTP). Multi-library guidance now stresses a unique directory to avoid route collisions.

Adds a new Generated pages section describing how Mintlify orders nav groups after tab groups, how grouping varies by format, per-symbol pages with cross-links, and the fallback Reference group for ungrouped pages.

Reviewed by Cursor Bugbot for commit 79e6952. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 24, 2026, 10:12 PM

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 24, 2026, 10:13 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ethanpalm
ethanpalm merged commit aa6d0ac into main Jul 24, 2026
6 checks passed
@ethanpalm
ethanpalm deleted the codex/sdk-reference-docs-follow-up branch July 24, 2026 22:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants